package com.vvv.shortlink.admin.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.vvv.shortlink.admin.dao.entity.UserDO;
import com.vvv.shortlink.admin.dto.req.UserLoginReqDTO;
import com.vvv.shortlink.admin.dto.req.UserRegisterReqDTO;
import com.vvv.shortlink.admin.dto.req.UserUpdateReqDTO;
import com.vvv.shortlink.admin.dto.resp.ActualUserRespDTO;
import com.vvv.shortlink.admin.dto.resp.UserLoginRespDTO;
import com.vvv.shortlink.admin.dto.resp.UserRespDTO;

/**
 * @author vvv
 * @description 针对表【t_user】的数据库操作Service
 * @createDate 2024-01-28 17:26:00
 */
public interface UserService extends IService<UserDO> {

    /**
     * 根据用户名查找用户信息
     *
     * @param username
     * @return 脱敏后的UserRespDTO
     */
    UserRespDTO getUserByUsername(String username);

    /**
     * 根据用户名查找用户无脱敏信息
     *
     * @param username
     * @return 完整用户信息
     */
    ActualUserRespDTO getActualUserByUsername(String username);

    /**
     * 判断用户名是否存在
     *
     * @param username
     * @return 存在返回true，不存在返回false
     */
    Boolean hasUsername(String username);

    /**
     * 注册
     *
     * @param requestParam 入参
     */
    void register(UserRegisterReqDTO requestParam);

    /**
     * 根据用户名修改用户信息
     *
     * @param requestParam
     */
    void update(UserUpdateReqDTO requestParam);

    /**
     * 登录
     *
     * @param requestParam
     * @return token
     */
    UserLoginRespDTO login(UserLoginReqDTO requestParam);

    /**
     * 检查用户是否登录
     *
     * @param username 用户名
     * @return true 已登录
     */
    Boolean checkLogin(String username);

    /**
     * 用户退出登录
     *
     * @param token    用户登录token
     * @param username
     */
    void logout(String token, String username);
}
